Refunding a Received Pix

After creating a Pix Charge and the amount has been computed in your bank account(cash-in), the recipient can return perform a refund operation for the payer - integral value (full) or partial value.

warning

📘 The refund process can only be carried out up to 90 days after the date of receipt.

🚧 Each partial refund can only be made in a 2 minute difference from each request to prevent issues, any request done under the 2 minutes difference will NOT be processed.

PUT 'https://apisandbox.delbank.com.br/baas/api/v1/pix/:endToEndIdOriginal/refund'

Headers

Nome	Descrição
x-delbank-api-key	Required. API Key
IdempotencyKey	Required. Necessary to ensure idempotency of the operation, Required to be a "uuid v4"

Path Parameters

Nome	Tipo	Descrição
endToEndIdOriginal	string	Required. The end to end of the original transaction

Body

Name	Type	Description
externalId	string	Must not exceed 40 characters. If you wish to pass an ID for payment conciliation.
amount	number	Required. Amount to be refunded
description	string	Internal transaction description

Example

{
    "description": "Pix recived incorrectly",
    "amount": 0.01
}

Response

O código de status 202 http indica uma transação bem-sucedida.

{
    "idempotencyKey": "421ece97-a8d2-4c45-afaf-3c8f81666fd2",
    "externalId": "158412e7-b97a-4ad5-ab70-f0d6aabee6e6",
    "endToEndId": "D38224857202502281706FA489GE2ZSN",
    "status": "PIX_PROCESSING",
    "createdAt": "2025-02-28T17:06:41.963Z"
}